PBM/PGM-Kit: SHORT MANUAL




PURPOSE


The archive contains two new loaders and savers for Ultraconv 3 and 4: PBM and PGM.

ARCHIVE CONTENTS


The archive should enclude the following files:

main directory

directory Commands/

directory Commands.68030/

directory Commands.ppc/

directory Loaders/

directory Savers/

If one of this files is missing, it would be better to get a full version of the archive, best you get it directly from my homepage.


COPYRIGHT


All files in this archive are copyrighted, that means (c) Stefan Diener. It is not allowed to
Any exception requires my personal agreement.

Note: Felix Schwarz (the author of Ultraconv) has the permission to publish the archive together with any new version of UConv.

It is allowed (accepting the restrictions above) to use the program and the source code for non-commercial purposes for free. If the source code (or a part of it) is used in another application or a given program will be developed further the developer has to ensure that both in program and new source codes full credits to the original author are given. I would be very happy getting a notice about the new developments. That means that I´m expecting a short message, for instance a quite short e-mail.

The author may change this copyright notice in further releases.

GUARANTEE


Just a joke ! No guarantee given ! There´s no guarantee whether the program runs on your computer or that it will do the job you thought it should. Nobody gives any liability for damages caused by proper or inproper use of the program. There´s no guarantee that the program´s output will be correct. No liability too. You are using the program at your own risk.

BUT: I was heavily working to debug the program and I spent a lot of time for testing it. The chance of undiscovered bugs is still greater than zero.


VERSION


This guide was made for release 1.02 of this package. If you have a newer version of the whole archive just forget this file.

RESTRICTIONS


Only the binary versions of PBM/PGM/PPM-files are supported. That means that you can not use file with the markers P1, P2 and P3 (text versions). I decided to do so because all programs of the NetPBM package write binary files and the text versions have the big fault to produce unneccessary big files. In practice this is no real restriction.

SOURCE CODE


Well, I tried to comment the source code and the include files as good as possible. I don´t want to explain the whole source, because I think that the comments will give enough help to you. Anyway, I will release a description of the include files in the next future. This will be a so called "developer release" for all of you who want to code something using STIMP. As you may noticed you don´t have to take care of file operations, so you only have to code the algorithm for transforming the picture(s) ... I suggest to take a look at my homepage and joining the STIMP mailing list.

News: You have to register for any STIMP package to get the whole source code including the developer documentation.


WHAT MEANS STIMP ?


You might be wondered by the name "STIMP". It´s quite simple: "STefan´s IMage Processing". Not surprising, isn´t it?

ENVIRONMENT


Compiler:

Computer:

AUTHOR


name : Stefan Diener
e-mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
address : Wilhelmstr. 7, D-73433 Aalen, Germany